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PREFACE 



This document describes the current state of the Multics Page Processing 
System support. The software described here is compatible with NIPOLOS IBM 
support release 3.21. Changes in PPS software may have an effect on the Multics 
interface described here. 

The software described in this manual was previously installed in the 
Multics experimental library. This is its first official release. 

When the term Multics is used as a noun in this document, it is meant to 
refer to the Multics operating system. Similarly, when the acronym PPS is used 
without parentheses, it is meant to refer to both the Page Printing System (PPS) 
and the Page Processing System (PPS II). 
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SECTION 1 



INTRODUCTION 



This document describes the software provided in 
support the Honeywell Page Processing System. 



the Multics system to 



THE PAGE PROCESSING SYSTEM 

The Page Processing System (PPS) is an off-line, non-impact printing system 
capable of printing up to 210 pages per minute (equivalent to 18,000 1pm). The 
PPS consists of one or more read-only tape drives, a system controller, a print 
unit, and one or more stacker units. 

The read-only tape units are capable of reading tapes written at 556, 800, 
or 1600 bpi. 

The system controller is a Honeywell 716 or Level-6 processor. 

The print unit employs a fixed electrographic print mechanism that moves 
the paper at a constant rate of 30 inches per second (20 ips on slower models) 
past a format drum containing the image of a "preprinted form" for fixed data 
such as horizontal lines or company logo. This format drum is mounted by the 
operator. 

After passing this drum the paper passes a print station capable of 
printing 132 character lines read from the input tape. This unit is capable of 
printing with 4, 6, 8, or 10 lines per inch vertically and 10 or 12 characters 
per inch horizontally. The print unit is also capable of printing up to 255 
copies of a report while reading the input tape only once. Also included in the 
print mechanism is a paper cutter and hole punch which allow a variety of page 
sizes and punched hole configurations. 

Each stacker unit provides 8 trays, each capable of holding up to 500 
sheets. Stacker algorithms supported include stacking one report per tray, one 
copy per tray (for multiple copy reports), and simple overflow from one tray to 
the next with or without separator sheets (a separator sheet is a blank page 
slightly longer than a printed page). 
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MULTICS INTERFACES 

Two user interfaces to the PPS are available on Multics. They are both 
described in this document. They are: the pps_ I/O module and the 
make_pps_tape command. 

The first, the pps_ I/O module, requires the user to take an active part in 
the preparation of the PPS tape. The user (or user's program) must attach, 
open, write to, close and detach the I/O switch being used. This method also 
requires access to use a tape drive on the Multics system. Examples 
demonstrating the use of the pps_ I/O module are given in Section 2, and a 
complete description of the I/O module can be found in Section 5. A complete 
description of the make_pps_tape command can be found in Section 4. 

The second interface, the make_pps_tape command, requires no extra effort 
on the part of the user or the system administrator. The user need only have 
access to write the PPS tape on the Multics system. 

The I/O module approach is usually better for producing large reports 
because it offers the user maximum control over the PPS functions employed in 
the production of the output and does not require that an intermediate copy of 
the report be online. The make_pps_tape command allows individual users (or 
groups of users) with printable files to produce tapes that can be processed on 
a PPS system. 
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SECTION 2 
USE OF THE pps I/O MODULE 



The pps_ I/O module is designed to give the user maximum control over the 
PPS reports produced. It provides for the generation of multiple report tapes 
while allowing full control over page format (i.e., page labels, indentation, 
channel stops, etc.). 



USING THE I/O MODULE 

The pps_ I/O module can be used with the I/O features of the Multics 
programming languages or by calling the iox_ subroutine directly to produce 
tapes that can be printed offline on the Page Processing System. There are no 
special restrictions on the number of reports per volume or the number of 
volumes per report. 



Using the I/O Module with Language I/O 

The pps_ I/O module should be used to attach and then open an I/O switch 
for each separate file being copied. The only opening mode supported is 
stream_output. Each time the I/O switch is attached and opened a new report is 
started on the output tape. Once the report has been written on the pps tape, 
the I/O switch is closed and detached and is then ready for another report. 
Subsequent reports simply require that the user repeat this at^acn, open, wri^e, 
close, detach sequence as often as necessary. 

For multiple reports, each attachment except the last one should be made 
with the -retain all option. The last attachment should be made with the 
-retain none option. These attachments can also be made with the retain_all and 
retain none control orders rather than, the -retain control argument. 



Using the I/O Module with iox_ 

When the iox_ subroutine is called directly, multiple report generation can 
be simplified greatly by using the new_report control order. For details, see 
the example in figure 2-3 and the description of the new_report control order in 
Sect ion 5 - 



PROGRAMMING EXAMPLES 

The examples that follow in this section show how a user can produce PPS 
output reports using the supported languages of Multics. See Section 5 for a 
complete description of the pps_ I/O module. 
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PL/I 

The PL/I example in figure 2-1 is designed to transfer a single report to 
an output tape. It queries the user for two arguments: the name of the file to 
be printed and the tape on which the output is to be placed. The program opens 
the input and output files, reads and writes the text, and finally closes the 
two files. 

The example of figure 2-2 shows the steps that must be taken to produce 
multiple reports on the same tape. The extra steps involved are required by the 
operation of PL/I I/O. 

Figure 2-3 shows yet another method of producing multiple reports on the 
same tape, but it does not use the -retain all control argument. Instead it 
uses the control order new_report, which is preferable because the program does 
not open and close the output file for each report and thus avoids the risk of 
leaving the output tape mounted but unattached. 

examplel : proc (); 

del buffer char (1000) varying; /* text buffer */ 

del com err entry options (variable); 

del endfile~condition; /• the end of file condition */ 

del file name char (168); /■ file to be displayed */ 

del input file; /* the input file »/ 

del output file; /* the output file */ 

del pl1 io $error_code entry (file) returns (fixed bin (35)); 

del sysln Input file; /* user_input «/ 

del sysprint print file; /* user_output */ 

del tape name char (32); /• reel id of the output tape «/ 

del undefinedfile condition; /* in case of error */ 

put skip list ("File name ?"); 

get list (file_name); 

on undefinedfile (input) begin; 

call com err_ (pl1_io_$error_code (input), "examplel", 

"Cannot open input file. File name = "a.", file_name); 

goto exit; 
end; 

open file (input) title ("vfile_ " ii file_name) stream input; 
revert undefinedfile (input); 

put skip list ("Tape name ?"); 

get list (tape_name); 

on undefinedfile (output) begin; 

call com_err_ (pl1_io_$error_code (output), "examplel", 

"Cannot open output file. Volume = ~a", tape_name); 

close file (input); 

goto exit; 

@nd * 

open file (output) title ("pps_ -volume " ii tape_name) print stream output ; 

revert undefinedfile (output); 

on endfile (input) goto all_done; /» watch for end of file */ 

do while ("1"b); 

read file (input) into (buffer); /* get a line */ 
write file (output) from (buffer); /» and write it */ 

all done* ' /* we have read all data */ 

close file (input), file (output); /* close all files «/ 
exit: return; 

end examplel ; 

Figure 2-1. A simple PL/I example. 
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example2: proc (); 



del buffer char (1000) varying; 

del code fixed bin (35); 

del com_err_ entry options (variable); 

del endfile condition; 

del file_name char (168); 

del input file; 

del output file; 

del output_opened bit (1) init ("0"b); 

del pl1_io_$error_code entry (file) ret 

del sysin input file; 

del sysprint print file; 

del tape_name char (32); 

del undefinedfile condition; 



/* text buffer */ 

/* error code from iox */ 

/* the end of file condition */ 

/* file to be displayed */ 

/* the input file */ 

/* the output file */ 

/* ON => tape was opened once */ 

urns (fixed bin (35)); 

/* user_input */ 

/* user_output */ 

/* volume name for output tape */ 

/* in case of error */ 



put skip list ("Tape name ?"); 
get list (tape_name); 

do while ("1"b); 



TRY AGAIN: 



put skip list ("File name ?"); 
get list (file_name); 
if file_name = "*" then goto EXIT; 
on undefinedfile (input) begin; 

call com err (pl1 io $error code (input), "example2", 



ALL DONE: 



EXI1 



end; 



end; 



"Cannot open input file, 
f ile_name) ; 
goto TRY AGAIN; 



File name 



open file (input) title ("vfile_ " II file_name) stream input; 
revert undefinedfile (input); 

on undefinedfile (output) begin; 

call com_err_ (pl1_io_$error_code (output), "example2", 

"Cannot open output file. Volume = ~a.", tape_name) ; 

close file (input); 

goto EXIT; 
end * 
open file (output) title ("pps_ -volume " | | tape_name i | " -ret all") 

print stream output ; 
revert undefinedfile (output); 
output_opened = "1"b; 

on endfile (input) goto ALL_D0NE; /* watch for end of file */ 

do while ("1"b); 

read file (input) into (buffer); /* get a line */ 
write file (output) from (buffer); /* and write it */ 

end; 

/* we have read all data */ 

close file (input), file (output); /* close all files */ 



if output_opened then do; /* tape ever attached? */ 

open file (output) title ("pps_ -volume " ! I tape_name I i 

print stream output; 
close file (output); 

end; 

return; 



-ret none") 



end example2; 



Figure 2-2. An example of writing multiple reports. 
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examples: proc (); 

del buffer char (1000) varying; /» text buffer */ 

del com err entry options (variable); 

del endfile~condition; /* end of file condition */ 

del file name char (168); /• file to be displayed */ 

del input file; /* the input file »/ 

del output file; /* the output file »/ 

del iocbp ptr; /* output IOCB ptr */ 

del iox $control entry (ptr, char (*), ptr, fixed bin (35)); 

del code fixed bin (35); /* error code »/ 

del pl1 io $error_code entry (file) returns (fixed bin (35)); 

del pl1 - io~"$get_iocb_ptr entry (file) returns (ptr); 

del sysln input file; /* user_input */ 

del sysprint print file; /* user_output */ 

del tape name char (32); /• reel id of output tape */ 

del undefinedfile condition; /* in case of error */ 

put skip list ("Tape name ?"); 

get list (tape_name); 

on undefinedfile (output) begin; 

call com_err (pl1_io_$error_code (output), "example3", 
"Cannot open output file. Volume = "a", tape_name) ; 
goto EXIT; 
end; 
open file (output) title ("pps_ -volume " i! tape_name) 

print stream output; 
revert undefinedfile (output); 

do while ( M 1"b); 

put skip list ("File name ?"); 

get list (file_name); 

if file_name = "*" then goto ALL_D0NE; 

on undefinedfile (input) begin; 

call com_err_ (pl1_io_$error_eode ( input) ^ "example3", 
"Cannot open input file. File name = "a.", 
f ile_name) ; 
goto NEXT; 

open file (input) title ("vfile_ " ii file_name) stream input; 

revert undefinedfile (input); 

iocbp = pl1_io_$get_iocb_ptr (output); 

call iox $control (iocbp, "new_report" , null (), code); 

if code "*"= then do; 

call com_err_ (code, "example3", 
"Unable to begin new report."); 

goto EXIT; 
end; 
on endfile (input) begin; 

close file (input); /* close this input file */ 

goto NEXT; 
end; 
do while ("1"b); 

read file (input) into (buffer); /* get a line */ 
write file (output) from (buffer); /* and write it */ 
end; 
NEXT: end; 

ALL_D0NE: close file (output); /* close all files »/ 

EXIT: return; 
end example3; 

Figure 2-3. Another example or writing mi 
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FORTRAN 

The FORTRAN example of figure 2-4 is simply a program to print the first 25 
powers of 2. Before executing this program, the user must attach I/O switch 
file03 using the pps_ I/O module with an io command, such as follows: 

io attach file03 pps_ w-100 

where w-100 is the name of a tape volume. Another version of this program with 
the file attachment specified in an or>en statement is shown in figure 2—5. Note 
that this sample program always asks for tape volume w-100. 



do 10 i=1 ,25 

10 write (03 , 1 1 ) i ,2**i 

11 format(1x,i5,i12) 
stop 

end 



Figure 2-4. A simple FORTRAN example. 



open (03,form="formatted" ,attach="pps_ w-1 00" ,mode="out" , 
& a ccess=" sequential") 
do 10 i=1 ,25 

10 write (03,11)1,2**1 

11 format(1x,i5,i12) 
stop 

end 



Figure 2-5. An example of use of the open statement, 
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COBOL 

The COBOL example program in figure 2-6 reads the file attached to the insw 
I/O switch and writes the content of this file on the PPS tape. Before 
executing this program, the user must attach both insw and outsw I/O switches 
using an io command, such as follows: 

io attach insw vfile_ xyz 
io attach outsw pps_ w-100 

where xyz specifies the file to be printed and w-100 is the name of a tape 
volume. Note that the COBOL program treats the PPS attachment as a printer and 
that the resultant report will be double spaced. 



identification division, 
program-id. example6. 
environment division, 
configuration section, 
source-computer. Multics. 
object-computer. Multics. 
input-output section, 
file-control . 

select external pps assign to outsw-printer 

select external qaz assign to insw; 

organization is stream, 
data division, 
file section, 
fd pps data record is pps-rec, 

label records are omitted. 
01 pps-rec picture x(120). 
fd qaz data record is qaz-rec, 

label records are omitted. 
01 qaz-rec picture x(120). 
working-storage section, 
procedure division, 
open-files. 

open input qaz. 

open output pps. 
loop. 

read qaz record; at end go to close-files. 

move qaz-rec to pps-rec. 

write pps-rec after advancing 2 lines. 

go to loop, 
close-files. 

close qaz, pps. 

stop run. 



Figure 2-6. A COBOL program to list a file on the PPS, 
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BASIC 



The BASIC example shown in figure 2-7 is the equivalent of the FORTRAN 
program in figure 2-5. Note that this sample program always asks for tape 



volume w-100. 



0010 file #1: ":foo pps_ -volume w-100" 
0020 for i = 1 to 25 
0030 print #1 : i; 2"i 
0040 next i 
0050 end 



Figure 2-7. A sample BASIC program. 
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SECTION 3 



There are limitations placed on the Multics user by the PPS interface 
described in this document. Some are avoidable by extra user coding, some are 
due to limitations of the Multics PPS support software, others are due to the 
PPS system itself. 



PAGE FORMAT 



The page format limitations are due to physical limitations of the PPS 
hardware. The PPS line length is limited to 132 print positions. That is, no 
print line can represent more than 132 columns of printed output. The page 
length is limited to a maximum of 93 lines per printed page. These values may 
be restricted further, of course, by the physical page dimensions. Tables 3-1 
and 3-2 show the line length and page length limits for all of the allowable 
page sizes. 



CHARACTER SETS 
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It is possible, using the cv_ppscf command, to define Multics ASCII strings 
(either single characters or sequences of overstruck characters) that represent 
any of the 8 bit characters of the PPS. See Section 4 for a description of 
cv_ppscf and Section 5 for a description of the -char_table control argument to 
the pps_ I/O module. 
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paper width 
( inches) 



5.0 
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11.0 



characters per line 
(physical line length) 



small characters 
(pitch = 12.8) 
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132 



large characters 
(pitch = 10) 

46 
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76 
81 
106 



Figure 3-1. Character positions per line. 
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SECTION 4 
MULTICS COMMANDS USED WITH PPS 



The commands described in this section allow the user to create tables to 
control character conversions done by pps_ and to create listings tapes for 
printing on the PPS. The discussion below briefly describes the context of the 
various divisions of the command descriptions. 



Name 

The "Name" heading for each command lists the full command name and any 
abbreviated form. The name is usually followed by a discussion of the purpose 
and function of the command and the expected results from the invocation. 



Usage 

This part of the command description first shows a single line that 
demonstrates the proper format to use when invoking the command and then 
explains each element in the line. The following conventions apply in the usage 
line. 

1. Optional arguments are enclosed in braces (e.g.. {path}. {User_ids}). 
All other arguments are required. 

2. Control arguments are identified in the usage line with a leading 
hyphen (e.g., {-control_args} ) simply as a reminder that all control 
arguments must be preceded by a hyphen in the actual invocation of the 
command . 

3. To indicate that a command accepts more than one of a specific 
argument, an "s" is added to the argument name (e.g., paths, {paths}, 
{-control_args} ) . 

NOTE: Keep in mind the difference between a plural argument name that is 
enclosed in braces (i.e., optional) and one that is not (i.e., 
required). If the plural argument is enclosed in braces, clearly no 
argument of that type need be given. However, if there are no 
braces, at least one argument of that type must be given. Thus 
"paths" in a usage line could also be written as: 

pathj_ {path2 ... pathn} , 

The convention of using "paths" rather than the above is merely a 
method of saving space. 
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Notes 

Comments or clarifications that relate to the command as a whole are given 
under the "Notes" heading. Also, where applicable, the required access modes, 
the default condition (invoking the command without any arguments), and any 
special case information are included. 



Examples 

The examples show different valid invocations of the command. An 

exclamation mark (!) is printed at the beginning of each user-typed line. This 

is done only to distinguish user-typed lines from system-typed lines. The 
results of each example command line are either shown or explained. 
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cv ppscf cv_ppscf 



Name : cv_ppscf 

The cv_ppscf command converts a data file known as a PPS character file 
into a source segment that is then assembled to create a PPS character table. 
This character table can then be used to control the translation of Multics 
ASCII characters and overstruck character sequences to PPS characters (a 
modified EBCDIC character set) . 



Usage 

cv_ppscf path {-control_args} 

where: 

1 . path 

is the pathname of the PPS character file. If the suffix ppscf is 
not supplied it is assumed. 

2. control_args 

can be chosen from the following: 

-list, -Is 

causes a listing file to be produced. The name of this file is the 
source path with the ppscf suffix replaced by the ppsctl suffix. 

-long, -lg 

causes a message reporting the usage of the available positions in 
the character matrix to be printed. 



Notes 

Execution of this command results in the creation of a segment called 

path. aim. The output segment must then be assembled using the Multics ALM 

assembler. The aim command is described in the MPM Subsystem Writers' Guide, 
Order No. AK92. 

The PPS character file consists of lines of character definitions. The 
first line of the file is used to specify the default character and space 
character as two hexadecimal values separated by white space. The default 
character is used to represent any character or sequence that is not defined in 
the remainder of the character file. The space character defines the PPS 
equivalent for the ASCII space character. The remaining lines define Multics 
ASCII equivalents for the PPS characters (one definition per line). 

A PPS character is defined by specifying the hexadecimal value for the 
character followed by the ASCII equivalent. This ASCII equivalent can be a 
series of ASCII characters, in which case the overstruck combination of these 
characters is defined. The sequence of ASCII characters can only contain 
printable characters. 

A PL/I like comment can be specified at the end of any line in the PPS 
character file. 
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cv ppscf cv_ppscf 



The delimiters used in parsing these definition lines are white space. 
This includes the characters space and horizontal tab. 

The one restriction on any overstruck sequence that is being defined is 
that all subsets of the overstruck sequence must also be defined in the 
character file. This means that if a user is defining "A" overstruck with "_" 
(i.e. "A") both "A" and " " must also be defined in the character file. 



Examples 

Listed below is the input file for the cv_ppscf command which defines three 
PPS characters (plus, minus, and underscore) and all of their combinations as 
overstruck characters. The hexadecimal representation is that of the ppf6025 
character table shown in figure A-2 in Appendix A. 

ff 40 /* define default and space characters */ 
04 +-_ /* now define PPS hex values for ASCII */ 
6d _ /* sequences listed */ 
4e + 
60 - 

31 -_ 
24 + 
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make pps tape make_pps_tape 



Name : make_pps_tape 

The make_pps_tape command is a convenient means by which a user can create 
a magnetic tape which can be printed on the PPS. 



Usage 

make_pps_tape target_spec paths 

where: 

1 . target_spec 

can be one of the following;, 

-volume volume_name, -vol volume_name 

specifies the name of the tape volume to be used. (see Notes 
below) . 

-target_description attach_desc, -tds attach_desc 

specifies the attach description to be used (See Notes below). 

2. path 

is the pathname of a file to be processed. 



Notes 

If the -volume control argument is specified the make_pps_tape command 
attaches a uniquely named I/O switch using an attach description of the form 
"pps_ -volume volume_name" . If the -target_description control argument is 
specified the make_pps_tape command will attach a uniquely named I/O switch 
using the attach description specified. Use of the -volume control argument is 
recommended rather than -target description because it is simpler. 



Examples 

In the following example all of the segments in the user's working 
directory with the suffix list will be written to tape 12763: 

! make_pps_tape -vol 12763 [segs **.list] 

The next example shows the use of -target_description : 

! make pps tape -tds "pps_ 12763 -ct ppf6025" [segs **.list] 
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PPS I/O MODULE 



This section describes the PPS I/O module. The description is similar to 
the I/O module descriptions found in MPM Subroutines (Order No. AG93) and MPM 
Peripheral Input/Output (Order No. AX49) . 

For a general description of the I/O system see "Multics Input/Output 
System" in section V of MPM Reference Guide (Order No. AG9D. 
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Name : pps_ 

This I/O module attaches a uniquely named target I/O switch using the 
tape_ibm_ I/O module, such that a tape suitable for processing on the PPS will 
be produced. 

Entry points in this module are not called directly by users; rather the 
module is accessed through the I/O system. 



Attach Description 

The attach description has the following form: 
pps_ {volids} t-control_args} 

where: 

1 . volid 

is the name of a tape volume to be used for output. 

2. control_args 

can be chosen from the following: 

-bottom_label XX, -blbl XX 

specifies that the string XX is to be used as a label at the bottom 
of every page of output until it is modified by the page_labels 
control order. 

-char_table XX, -ct XX 

specifies the pathname of the PPS character table to be used. The 
default character table is ppf6023 (see Appendix A). This character 
table is created using the cv_ppscf command. 

-density n, -den n 

specifies the density of the tape to be produced, where n can be 
either 1600 or 800. If this control argument is not given, the tape 
will be produced at 1600 bpi. 

-label XX, -lbl XX 

specifies the string XX as a label at the top and bottom of every 
page until it is modified by the page_labels control order. 

-modes XX, -mds XX 

specifies the initial mode string XX to be used. (See "Modes 
Operation" below.) 

-number n, -nb n 

specifies the file number at which this report is to begin. This 
control argument can be used to add new reports to an existing tape 
or overwrite specific reports on a tape (see tape_ibm_ in MPM 
Peripheral Input/Output, Order No. AX49, for details). "" Since a 
single attachment can result in multiple output files being placed 
on the tape, care must be taken when using this control argument. 
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-regain XX j — reL, aX 

specifies the disposition of the PPS tape on detachment of this 
switch. Valid values for XX are "all" and "none". The default is 
"none" . 

-top_label XX, -tlbl XX 

specifies the string XX as a label to be used at the top of every 
page of output until it is modified by the page_labels control 
order. 

-volume XX, -vol XX 

specifies the tape volume XX as an output tape volume for the target 
attachment. This control argument must be used when a volume name 
begins with a hyphen (-). 



Open Operation 

The only opening mode supported is stream_output . Opening the I/O switch 
results in the attachment and opening of the target switch. 



Close Operation 

Closing the I/O switch results in the closing and detachment of the target 
switch, thus terminating the current PPS output report. 



* _ A. _ — i_ r\ 



Detaching the I/O switch releases any temporary segments created during the 
attachment. 



put_chars Operation 

The put_chars operation formats the data into a form acceptable to the PPS 
and writes it on the output tape. 
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Control Operation 

The I/O module supports the following control operations. 

channel_stops 

end_of_page 

get_count 

get_error_count 

get_position 

inside_page 

new_report 

outside_page 

page_labels 

paper_info 

pps_paper_info 

reset 

retain_all 

retain_none 

runout 

set_position 

In the descriptions below, info_ptr is the information pointer specified in the 
iox_$control call. Unless specified otherwise, the I/O switch can be either 
open or closed when processing control orders. 

channel_stops 

sets the software channel stops. The info_ptr must point to the 
following structure in which the channel stops are specified 
(prt_order_info.incl.pl1 ) : 

del channel_stops(256) bit(l6) based( info_ptr) unaligned; 
where: 

channel_stops 

defines which of the 16 possible channel stops have been set in 
each of the 256 possible lines on a physical page 

end_of_page 

positions the output to the end of the current page and writes the 
bottom page label if specified. The I/O switch must be open. 

get_count 

returns information about the current page format and print position. 
The info_ptr must point to the following structure 
(prt_order_info.incl.pl1 ) : 

del 1 counts based(info_ptr) aligned, 

2 line fixed bin, 

2 page_length fixed bin, 

2 lmarg fixed bin, 

2 rmarg fixed bin 

2 line_count fixed bin, 

2 page_count fixed bin; 

where: 

line 

is the current line number. 
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page_length 

is the current page length. 

Imarg 

is the current left margin column. 

rmarg 

is the current right margin column. 

line_count 

is the number of lines printed since the last reset. 

page_count 

is the number of pages printed since the last reset. 

get_error_count 

is simply provided for compatibility with the printer software. The 
info_ptr must point to the following return value 
(prt_order_info.incl.pl1 ) : 

del ret_error_count fixed bin based( info_ptr) ; 

where ret_error_count is always returned as zero. 

get_position 

returns the current print position and certain statistics. The 
info_ptr must point to the following structure 
(prt_order_info.incl.pl1): 

del 1 position_data based( info_ptr) aligned, 

2 line_number fixed bin(35), 

2 page_number fixed bin(35), 

2 total_lines fixed bin(35), 

2 total_chars fixed bin(35) , 

2 pad (4) fixed bin; 

where: 

line_number 

is the current line on the page. 

page_number 

is the current page number. 

total_lines 

is the number of lines printed since the last reset order. 

total_chars 

is the number of characters processed since the last reset order. 

pad 

is reserved for future use. 

inside_page 

moves the current print position to the top of the next page. The I/O 
switch must be open. 

new_report 

starts a new report on the current PPS tape. This implicitly does a 
reset control order. The I/O switch must be open. 
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outside_page 

moves the current print position to the top of the next page. 
switch must be open. 



The I/O 



page_labels 

sets the current page labels. If the info_ptr is null the page labels 
are reset and will not appear on output produced. If the "endpage 
mode has been specified an error will result. To set page labels the 
info_ptr must point to the following structure 
(prt order info.incl .pl1 ) : 



del 1 page_labels 
2 top_label 
2 bottom label 



based(info_ptr) aligned, 

char(136), 

char(136); 



where: 

top_label 

is the label placed at the top of every page. 

bottom_label 

is the label placed at the bottom of every page. 



paper_info 

sets the current page size. If an invalid paper size is specified an 
error will occur (see figure 3-D. The pitch is always set to 12.5 
characters per inch by this control order. This order is supported 
for compatibility with the printer software. The info_ptr must point 
to the following structure (prt_order_info.incl.pl1): 



del 1 paper_info 

2 phys_page_length 
2 phys_line_length 
2 lines per inch 



based( info_ptr) aligned, 
fixed bin, 
fixed bin, 
fixed bin; 



where: 

phys_page_length 

is the number of lines that would be printed on the page if all 
lines were printed (as when in "endpage mode). 

phys_line_length 

is the number of print positions per line on the page. 

lines_per_inch 

is the number of printed lines per inch of paper. 



pps_paper_info 

sets the page size being processed. This control order should be used 
rather than paper_info whenever possible. The info_ptr must point to 
the following structure (pps_paper_info.incl.pl1): 



del 1 pps_paper_info 
2 sheet_width 
2 sheet_length 
2 lines_per_inch 
2 chars per inch 



aligned based( info_ptr ) , 
fixed dec(5, 1) , 
fixed dec(5,1 ) , 
fixed dec(5,D , 
fixed ded(5,1) ; 



5-6 



CJ97-00 



pps pps_ 



where: 

sheet_width 

is the width in inches of the paper to be used. Valid values 
are: 5.0, 5.5, 7.5, 8.0, 8.5, and 11.0. 

sheet_length 

is the length in inches of the paper to be used. Valid values 
are: 3-0, 3.5, 4.0, 4.5, 5.0, 5.5, 6.0, 7.0, 8.0, 8.5, 10.0, 
11.0, 12.0, and 14.0. 

lines_per_inch 

is the number of lines per inch. Valid values are: 4.0, 6.0, 
8.0, and 10.0. 

chars_per_inch 

is the number of characters per inch (pitch). Valid values are: 
10.0 and 12.5. 

reset 

sets the default mode, and resets the number of lines printed and the 
number of characters processed. This control order is included to 
make programs written for printer software compatible with PPS 
software. 

retain_all 

causes the retain_all order to be passed to the target 1/0 switch. 
This causes the output tape to be retained when the I/O switch is 
detached. This control order should be used as described in Section 
2. 

retain_none 

nQ5n{-e v» n 4- n {vt fti i tvi to ^»i-»v*+-*./-»i Av/iflr sho 11 ! d be u ssd as described in 

Section 2. 

runout 

causes all data buffered internally by the pps_ I/O module to be 
written to the tape. 

set_position 

sets the line, page and character counts kept by the 1/0 module. The 
info_ptr must point to the same structure as for the get_position 
control order. The line_number value supplied is ignored. This 
control order is included to make programs written for printer 
software compatible with PPS software. 



Modes Operation 

The modes operation is supported whenever the switch is attached. The 
recognized modes are listed below. These modes are also accepted following the 
-modes control argument in the pps_ attach description. 

default 

resets all modes to their default values. This is equivalent to 

setting the modes endpage, vertsp, edited, fold, "esc, print, 11<LL> , 

pl<PL>, inO, stopO where <LL> is the current physical line length and 

<PL> is the current physical page length minus the number of lines per 
inch. 
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debug, "debug . 

causes the I/O module to enter debug mode. This mode is not 
recommended for users. (Default is "debug.) 

edited, "edited 

specifies that ASCII control characters that do not affect carriage or 
paper motion are to be escaped (e.g., \177 for DEL). Otherwise, these 
control characters are ignored. (Default is "edited.) 

endpage, "endpage 

specifies that when the normal printed area of a page is overflowed, 
printing is continued on the next page. Otherwise, text is printed on 
every line of the physical page. (Default is endpage.) 

6 SC ^ 6 SG 

specifies that the special processing of the ASCII ESC character is to 
be enabled. (Default is "esc.) 

fold, "fold „ . . , 

specifies that lines that are longer than the line length are folded 
to the next line. Otherwise, such lines are truncated to n print 
positions (where n is the current line length). (Default is fold.) 

inn ., _■ ,. 

~ specifies that each line of output is to preceded by n spaces. 

(Default is in 0.) 

specifies the length in print positions of the output line. When an 
attempt is made to use more than n print positions on a line the 
remaining text is moved to the next line or discarded depending on the 
setting of the fold mode. (Default is 11 132.) 

specifies the length in lines of the printed page. When an attempt is 
made to print the n+1th line on the page a form feed character is 
inserted causing the output to proceed on a new page unless the 
endpage mode is off. (Default is pi 60.) 

plln ™, . 

~ specifies the physical line length in characters. This value cannot 

be smaller than the line length. (See figure 3-D- (Default is pll 
132.) 

ppln , 

~ specifies the physical page length in lines. This value must be 
chosen to correspond to a valid PPS paper size (see figure 3-2). 
(Default is ppl 64.) 

vertsp, "vertsp 

performs the vertical tab and form feed functions. Otherwise, these 
characters are simply mapped into newline characters. (Default is 
vertsp. ) 

In order to provide some compatibility with the printer software, some 
additional modes are supported: 

1pg 

has no effect on the pps_ I/O module. 

non edited, "non_edited 

is the complement of edited (i.e., non_edited = edited). 
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noskip 

is the complement of endpage (i.e., noskip = "endpage) . 

pr int , " pr int 

has no effect on the pps_ I/O module. 

single, "single 

is the complement of vertsp (i.e., single = "vertsp) . 

stopn 

has no effect on the pps_ I/O module. 

truncate, "truncate 

is the complement of fold (i.e., truncate = "fold). 



Notes 

Because the target I/O switch uses the tape_ibm_ I/O module, the user's 
process may get queries from tape_ibm_. See Peripheral Input/Output (Order No. 
AX49) for a description of tape_ibm_. 

The volume names specified in the attach description are used in the order 
they appear in the attach description. 

There are two character tables supplied as part of the released PPS 
software. They are ppf6023 and ppf6025. The ppf6023 character table contains 
92 printable ASCII characters with all of the underscored characters mapped to 
remove the underscores. The ppf6025 character table contains these same 92 
printable characters as well as these characters overstruck with the underscore 
character. For a full description of these character tables see Appendix A. 

The I/O module may hold data in buffers between operations. For this 
reason no operations should be attempted on the target I/O switch while it is 
being used with the pps I/O module. 
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APPENDIX A 
MULTICS PPS CHARACTER SETS 



There are two PPS character sets supported by the Multics PPS support 

package. The character set in figure A-1 is the ASCII character set without 

underscored characters (ppf6023). The second character set allows a number of 

overstruck character sequences in addition to the characters in figure A-1 . 
These additional characters are shown in figure A-2. 

The figures that follow show the correspondence between the PPS character 
set and the Multics ASCII character set. The PPS characters are shown in 
hexadecimal and the ASCII characters or character sequences are shown without 
backspaces. Figure A-1 for example shows that the ASCII string A is the same as 
the PPS character represented by C1(16). 
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Figure A-2. The ppf6025 character table. 
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MULTICS PPS TAPE FORMAT 



The tapes produced by the Multics PPS support package are described in 
detail in "OS and DOS Support for the Page Processing System" (Order No. AR86) . 
This format in terms of a Multics tape_ibm_ attach description is: 

tape_ibm_ -vol volid -format fb -rec 133 -block 1596 -mode ascii ... 

The tape is written using the ASCII mode due to the fact that character 
translation to the PPS character set is accomplished using the PPS character 
table. 

See MPM Peripheral Input/Output (Order No. AX49) for a complete 
description of tape ibm . 
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make_pps_tape command 
see commands 
?ga M 1 'Itics interfaces 

Multics interfaces 
see commands 

make_pps_tape 
see I/O modules 
pps_ 

multiple report tapes 1-2, 2-3, 2-4 

multiple reports 2-2 







overstruck character 3-1, 1-2, 5-9 



page format 1-1, 3-1, 5-2 
line length 3-1, 5-6, 5-E 
page length 3-1, 5-6, 5-1 

page labels 1-2 

paper cutter 1-1 

PL/I 2-1, 2-2, 2-3, 2-4 

PPS components 
print unit 1-1 
read-only tape drive 1-1 
stacker unit 1-1 
system controller 1-1 

pps_ 

see I/O modules 



preprinted form 1-1 

print unit 

see PPS components 



read-only tape drive 
see PPS components 



language I/O 

see I/O modules 



separator sheets 1-1 

stacker unit 

see PPS components 

system controller 
see PPS components 
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